Repository navigation
unity-cli@v4.0.0 - #86
Merged
Merged
Conversation
![github-advanced-security[bot]](https://avatars.githubusercontent.com/in/57789?s=60&v=4){kind=small}
There was a problem hiding this comment.
🟡 Changes recommended
Serial disclosure and unresolved licensing, editor selection, module installation, and launch regressions block approval.
6 open issues
What changed in this PR
Migrates unity-cli v4 from Unity Hub management to a companion for Unity’s official CLI, retaining legacy editor support, licensing fallbacks, Android SDK setup, and annotated Editor logs.
Changes:
- Adds official CLI installation, caching, editor installation, and launch integration.
- Reworks licensing and removes overlapping Hub, project, and package commands.
- Updates migration documentation, tests, dependencies, and CI workflows.
| File | Description |
|---|---|
| tests/upm-cli.test.ts | Removes tests for the retired UPM wrapper. |
| tests/unity-installer-release-api-filter.test.ts | Moves release-filter tests to UnityInstaller. |
| tests/unity-hub.test.ts | Removes Hub integration tests. |
| tests/unity-editor.test.ts | Uses local fixtures and tests launch arguments. |
| tests/unity-cli.test.ts | Adds CLI helpers, licensing fallback, and redaction tests. |
| tests/mocks/electron-asar.js | Removes the obsolete ASAR mock. |
| tests/linux-hub-path.test.ts | Removes Hub path tests. |
| tests/hub-cdn-urls.test.ts | Removes Hub CDN checks. |
| src/upm-cli.ts | Removes the UPM wrapper. |
| src/unity-installer.ts | Adds official CLI and legacy archive installation paths. |
| src/unity-hub.ts | Removes Hub management. |
| src/unity-editor.ts | Integrates official CLI launches with direct-launch fallbacks. |
| src/unity-cli.ts | Adds CLI discovery, downloads, caching, and command execution. |
| src/logging.ts | Adds PATH export support. |
| src/logger-provider.ts | Extends the logger interface for PATH updates. |
| src/license-client.ts | Adds CLI-first licensing, fallback discovery, and redaction. |
| src/index.ts | Exports the new CLI and installer APIs. |
| src/github-actions-ci.ts | Adds PATH exports and environment newline guards. |
| src/cli.ts | Replaces retired commands with the v4 command surface. |
| src/android-sdk.ts | Retries Android SDK package installation. |
| README.md | Documents v4 usage, migration, and maintenance scope. |
| package.json | Sets version 4.0.0 and revises dependencies. |
| package-lock.json | Synchronizes dependency changes. |
| jest.config.mjs | Removes ASAR mock mapping. |
| docs/unity-version-support.md | Replaces Hub-specific wording. |
| .github/workflows/unity-release-discovery.yml | Updates checkout and Node setup actions. |
| .github/workflows/unity-build.yml | Migrates build steps to v4 and official CLI commands. |
| .github/workflows/publish.yml | Updates checkout and Node setup actions. |
| .github/workflows/integration-tests.yml | Updates setup and timeline actions. |
Review effort: Balanced
This was
linked to
issues
Oct 26, 2026
…se drift report in the run summary
…eg and pulseaudio
…ild profiles through one file handle
…tor packages, and rerun marked license failures
…mpeg opt-in on linux
…rypted instead of caching it in secrets
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
unity); install it on first use, latest by default (--unity-cli-versionto pin)unity install; 5.x from Unity's archive, 4.x with the legacy installerunity license, then the licensing clientreturn-license --when)rungoes throughunity runfor 2019.1+ projectsinstall-all-toolsandsign-packageuninstall-unity,list-project-templates,create-projectandopen-project; they forward tounity